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LiveCode 8.1 provides important improvements for delivering high-quality cross-platform 
applications! 


e LiveCode Indy and Business editions now come with the tsNet external, which supercharges 
LiveCode's Internet features and performance. LiveCode 8.1 also introduces mergHealthkKit, 
for accessing activity, sport and health data on iOS devices. 


e The standalone builder now has a greatly-improved user experience for including externals, 
script libraries and LiveCode Builder extensions in your cross-platform application. Usually, 
it'll now do the right thing automatically, but you can still select the specific inclusions you 
need. 


e The IDE has lots of other upgrades, too: a keyboard-navigable Project Browser that 
highlights any scripts that failed to compile, an improved dictionary user interface, and 
access to the message box just by starting to type. 


e The player control can be used in Windows application without any need for users to install 
any additional libraries or dependencies, thanks to a brand new player implementation 
based on DirectShow. For most apps, it should now be unnecessary to install or use 
QuickTime at all. 


e The LiveCode Builder programming language has had some enhancements as part of the 
Infinite LiveCode project. Variables now get initialised by default, unsafe blocks and 
handlers can be used to flag sections of code that do dangerous things, and you can even 
include raw bytecode if necessary. 


Known issues 





e The installer will currently fail if you run it from a network share on Windows. Please copy the 
installer to a local disk before launching on this platform. 


e The browser widget does not work on 32-bit Linux. 


e 64-bit standalones for Mac OS X do not have support for audio recording or the 
revVideoGrabber external. 
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The engine supports a variety of operating systems and versions. This section describes the 
platforms that we ensure the engine runs on without issue (although in some cases with reduced 
functionality). 


Windows 


LiveCode supports the following versions of Windows: 
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e Windows XP SP2 and above 

e Windows Server 2003 

e Windows Vista SP1 and above (both 32-bit and 64-bit) 
e Windows 7 (both 32-bit and 64-bit) 

e Windows Server 2008 

e Windows 8.x (Desktop) 

e Windows 10 


Note: On 64-bit Windows installations, LiveCode runs as a 32-bit application through the WoW 
layer. 


Linux 


LiveCode supports the following Linux distributions, on 32-bit or 64-bit Intel/AMD or compatible 
processors: 


e Ubuntu 14.04 and 16.04 

e Fedora 23 & 24 

e Debian 7 (Wheezy) and 8 (Jessie) [Server] 
e CentOS 7 [server] 


LiveCode may also run on Linux installations which meet the following requirements: 
e Required dependencies for core functionality: 


o glibc 2.13 or later 
o glib 2.0 or later 


e Optional requirements for GUI functionality: 


0 GTK/GDK 2.24 or later 

o Pango with Xft support 

°o esd (optional, needed for audio output) 

o mplayer (optional, needed for media player functionality) 

°o Icms (optional, required for color profile Support in images) 
° gksu (optional, required for privilege elevation support) 


Note: If the optional requirements are not present then LiveCode will still run but the specified 
features will be disabled. 


Note: The requirements for GUI functionality are also required by Firefox and Chrome, so if your 
Linux distribution runs one of those, it will run LiveCode. 


Note: It may be possible to compile and run LiveCode Community for Linux on other 
architectures but this is not officially supported. 


Mac 


The Mac engine supports: 


e 10.6.x (Snow Leopard) on Intel 
e 10.7.x (Lion) on Intel 
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e 10.8.x (Mountain Lion) on Intel 
e 10.9.x (Mavericks) on Intel 

e 10.10.x (Yosemite) on Intel 

e 10.11.x (El Capitan) on Intel 

e 10.12.x (Sierra) on Intel 


iOS 
IOS deployment is possible when running LiveCode IDE on a Mac, and provided Xcode is installed 
and has been set in LiveCode Preferences (in the Mobile Support pane). 


Currently, the supported versions of Xcode are: 


e Xcode 4.6 on MacOS X 10.7 

e Xcode 5.1 on MacOS X 10.8 

e Xcode 6.2 on MacOS X 10.9 

e Xcode 6.2 and 7.2 on Mac OS X 10.10 
e Xcode 8.2 on MacOS X 10.11 

e Xcode 8.3 on MacOS 10.12 


It is also possible to set other versions of Xcode, to allow testing on a wider range of iOS 
Simulators. For instance, on OS X 10.10 (Yosemite), you can add Xcode 5.1 in the Mobile Support 
preferences, to let you test your stack on the /OS Simulator 7.1. 


We currently support deployment for the following versions of iOS: 


e 6.1 [simulator] 
e 7.1 [simulator] 
e 8.2 [simulator] 
e 9.2 

e 10.2 

e 10.3 


Android 


LiveCode allows you to save your stack as an Android application, and also to deploy it on an 
Android device or simulator from the IDE. 


Android deployment is possible from Windows, Linux and Mac OSX. 


The Android engine supports devices using ARMv6, ARMv7 or ARMVv8 processors. It will run on the 
following versions of Android: 


e 2.3.3-2.3.7 (Gingerbread) 
e 4.0 (Ice Cream Sandwich) 
e 4.1-4.3 Jelly Bean) 

e 4.4 (KitKat) 

e 5.0-5.1 (Lollipop) 

e 6.0 (Marshmallow) 


To enable deployment to Android devices, you need to download the Android SDK, and then use 
the ‘Android SDK Manager to install: 
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e the latest "Android SDK Tools" 
e the latest "Android SDK Platform Tools" 


You also need to install the Java Development Kit (JDK). On Linux, this usually packaged as 
"openjdk". LiveCode requires JDK version 1.6 or later. 


Once you have set the path of your Android SDK in the "Mobile Support" section of the LiveCode 
IDE's preferences, you can deploy your stack to Android devices. 


Some users have reported successful Android Watch deployment, but it is not officially supported. 


HTMLS5 


LiveCode applications can be deployed to run in a web browser, by running the LiveCode engine in 
JavaScript and using modern HTMLS5 JavaScript APIs. 


HTML5 deployment does not require any additional development tools to be installed. 


LiveCode HTML5 standalone applications are currently supported for running in recent versions of 
Mozilla Firefox, Google Chrome or Safari. For more information, please see the "HTML5 
Deployment" guide in the LiveCode IDE. 


Setup 





Installation 


Each version of LiveCode installs can be installed to its own, separate folder. This allow multiple 
versions of LiveCode to be installed side-by-side. On Windows (and Linux), each version of 
LiveCode has its own Start Menu (or application menu) entry. On Mac OS X, each version has its 
own app bundle. 


On Mac OS xX, install LiveCode by mounting the .dmg file and dragging the app bundle to the 
Applications folder (or any other suitable location). 


For Windows and Linux, the default installation locations when installing for "All Users" are: 


Platform Path 
Windows <x86 program files folder>/RunRev/LiveCode <version> 


Linux /opt/livecode/livecode-<version> 


The installations when installing for "This User" are: 


Platform Path 

incu <user roaming app data folder>/RunRev/Components/LiveCode 
<version> 

Linux ~/.runrev/components/livecode-<version> 
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Note: If installing for "All Users" on Linux, either the gksu tool must be available, or you must 
manually run the LiveCode installer executable as root (e.g. using sudo or su). 


Uninstallation 


On Windows, the installer hooks into the standard Windows uninstall mechanism. This is accessible 
from the "Add or Remove Programs" applet in the windows Control Panel. 


On Mac OS xX, drag the app bundle to the Trash. 


On Linux, LiveCode can be removed using the setup.x86 or setup.x86 64 program located in 
LiveCode's installation directory. 


Reporting installer issues 


If you find that the installer fails to work for you then please report it using the LiveCode Quality 
Control Centre or by emailing support@livecode.com. 


Please include the following information in your report: 


e Your platform and operating system version 

e The location of your home or user folder 

e The type of user account you are using (guest, restricted, admin etc.) 
e The installer log file. 


The installer log file can be located as follows: 


Platform Path 
Windows 2000/XP <documents and settings folder>/<user>/Local Settings/ 
Windows Vista/7 <users folder>/<user>/AppData/Local/RunRev/Logs 


Linux <home>/.runrev/logs 


Activating LiveCode Indy or Business edition 


The licensing system ties your product licenses to a customer account system, meaning that you 
no longer have to worry about finding a license key after installing a new copy of LiveCode. 
Instead, you simply have to enter your email address and password that has been registered with 
our customer account system and your license key will be retrieved automatically. 


Alternatively it is possible to activate the product via the use of a specially encrypted license file. 
These will be available for download from the customer center after logging into your account. This 
method will allow the product to be installed on machines that do not have access to the internet. 


Command-line installation 


It is possible to invoke the installer from the command-line on Linux and Windows. When doing 
command-line installation, no GUI will be displayed. The installation process is controlled by 
arguments passed to the installer. 
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Run the installer using a command in the form: 


<installer> install noui [OPTION ...] 


where <installer> should be replaced with the path of the installer executable or app (inside 
the DMG) that has been downloaded. The result of the installation operation will be written to the 
console. 


The installer understands any of the following OPTIONs: 


Option Description 
Install the IDE for "All Users". If not specified, LiveCode will be installed 
-allusers 
for the current user only. 
deshenanatieeteun Place a shortcut on the Desktop (Windows-only) 
-startmenu Place shortcuts in the Start Menu (Windows-only) 
-location The folder to install into. If not specified, the LOCATION defaults to those 
LOCATION described in the "Installation" section above. 
“og LOGFILE The file to which to log installation actions. If not specified, no log is 
generated. 


Note: the command-line installer does not do any authentication. When installing for "All Users", 
you will need to run the installer command as an administrator. 


As the installer is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


Start /wait <installer> install noui [OPTION ...] 


Command-line uninstallation 


It is possible to uninstall LiveCode from the command-line on Windows and Linux. When doing 
command-line uninstallation, no GUI will be displayed. 


Run the uninstaller using a command of the form: 
<uninstaller> uninstall noui 


Where is .setup.exe on Windows, and .setup.x86 on Linux. This executable, for both of the 
platforms, is located in the folder where LiveCode is installed. 


The result of the uninstallation operation will be written to the console. 


Note: the command-line uninstaller does not do any authentication. When removing a version of 
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LiveCode installed for "All Users", you will need to run the uninstaller command as an 
administrator. 


Command-line activation for LiveCode Indy or Business edition 


It is possible to activate an installation of LiveCode for all users by using the command-line. When 
performing command-line activation, no GUI is displayed. Activation is controlled by passing 
command-line arguments to LiveCode. 


Activate LiveCode using a command of the form: 


<livecode> activate -file LICENSEFILE -passphrase SECRET 


where <livecode> should be replaced with the path to the LiveCode executable or app that has 
been previously installed. 


This loads license information from the manual activation file LICENSEFILE, decrypts it using the 


given SECRET passphrase, and installs a license file for all users of the computer. Manual 
activation files can be downloaded from the My Products page in the LiveCode account 
management site. 


It is also possible to deactivate LiveCode with: 

<lLivecode> deactivate 

Since LiveCode is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


Start /wait <livecode> activate -file LICENSE -passphrase SECRET 
Start /wait <livecode> deactivate 


On Mac OS xX, you need to do: 


<Livecode>/Contents/MacOS/LiveCode activate -file LICENSE -passphrase SECRET 
<Livecode>/Contents/MacOS/LiveCode deactivate 


male lalomear-) ale ors 





Fix deletion of the target in safe cases (8.1.4-rc-2) 
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You can now Safely ‘delete the target’ as long as there are no handlers on the stack owned by the 
target. 


After deleting 'the target’, 'the target’ will become empty which will result in an execution error 
when an attempt is made to dereference it. 


Ensure browser widgets are in the correct location (8.1.4-rc-2) 


Browser widgets in nested groups now remain in the correct location rather than shifting down 
vertically out of sync with everything else. 


Script-only deploy (8.1.4-rc-1) 


It is now possible to use script-only stacks in the mainstack and auxiliary stack parameters to the 
deploy command. 


Specific engine bug fixes (8.1.4-rc-3) 


19730 Fix resolution of relative paths of images in Mac standalones 


Specific engine bug fixes (8.1.4-rc-2) 


19026 Fix DNS resolver isSue causing connection hang when using tsNet on Linux 


19525 
13573 
19577 
19578 
19584 
19587 
19592 
19635 


Fix SFTP connection hang when remote directory doesn't exist 
Provide iOS 10.3 builds for tsNet 

Fix crashes related to card deletion 

Fix crash after leaving edit group mode 

Allow deletion of a message's target object in a frontscript 

Fix deletion of the target in safe cases 

Prevent crash when deleting combo box 

Ensure browser widgets are in the correct location 


Specific engine bug fixes (8.1.4-rc-1) 


10947 
11170 
11727 


I2137 


14238 
17577 
18058 
18273 


Fix hypercard-compatibility dynamic path behavior 

Disable keyboard suggestion when entering password in Android native input field. 
Fix arrow key not work in Android field 

Make sure keyboardActivated/keyboardDeactivated messages are sent when the 
Status bar is hidden on Android 

Ensure background pattern stays aligned in long fields 

Make sure we can set the hiliteditemName property of the navBar widget 

Fix keyboard not show in landscape orientation 

Prevent crash when rendering card with invalid objptr 

Make sure mobileControlGet does not return rounded values of 


18358 
18454 
18539 


18619 
18833 
18912 


18946 
19060 


19116 


i136 
19154 
19192 
19200 
19212 


IgZ15 


19229 
19246 
19279 
19287 
19293 
19298 
19307 
19313 
19320 
19328 
19352 
19390 
19404 
19416 
19417 
19424 
19457 
19469 
19490 
19500 
19515 
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startTime/endTime/currentTime 
Allow socket to send broadcast packet on Android. 
Don't change the defaultFolder on startup 


Delete slash at the end of specialFolderPath("resources") to be consisten with other 
result of special folders. 


Don't change name of tsNet stack during standalone build 

Ensure objects can't be deleted if their behaviors are handling a message or they are 
the target 

Fix browserNavigateComplete not firing when document has frames 

Ensure error when binding widget is caught correctly 

Ensure tsNetGetStatus reports transfer status as "uploading" appropriately during 
POST requests 

Update OpenSSL to version 1.1.0d 

Fix widget browser stuck on handling javascript 

Add ios and android to "allowDatagramBroadcasts" dictionary entry 

Make sure printSettings are set correctly 

Prevent a crash when calling mobileComposeMail with just one param (tSubject) 
Make sure botton icons are present in standalones when building for multiple 
platforms 

Fix crash when connecting an IR Receiver 

Remove objects from message path ASAP when deleted 

Prevent mobilePickMedia crash without 'Write External Storage’ permission 

Make sure the clickLoc is updated on mouseDown/touchEnd on mobile 

Server returns 'ELF' over HTTP 

Make sure "Search for Inclusions" detects correctly widget inclusions on iOS simulator 
Prevent crash when saving standalone while player is playing 

Fix crash when saving field with fdata 

Fix SVG parsing of ‘a’ instruction 

Standalone startup stack needs to be mainstack before resolving parent scripts 
Fix crash when getting the urlResponse 

Reposition native layer controls correctly when resizing stacks 

Fix crash on iOS when calling play empty followed by play path/to/audio/file 
Ensure all object messages are cleared when obj or ancestor is deleted 

Use correct comment syntax in docs on documentation 

Make sure getting the securityPermissions returns the expected result 
Prevent crash when deleting selected objects with the backspace key 

Make sure the long time format is correct if twelveHourTime is false 

Make sure launch url sets the result to empty on success 

Fix crash when invalid url is used with iOS native browser 

Ensure the formattedRect of line N always returns the correct result 
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Specific IDE bug fixes (8.1.4-rc-2) 


19564 


Prevent error when deleting script editor tab 


Specific IDE bug fixes (8.1.4-rc-1) 


17448 
18035 
18485 
18549 
18991 
19152 
I3IS3 
19160 
ISL? 7 
19178 
19179 
191sl 
19188 
19195 
19196 
19439 
19451 


Make sure messages are sent when going to stacks/cards from the Project Browser 
Make sure the gradient popup stack is displayed as expected 

Ensure relayering menu items don't relayer objects out of owner groups 

Make sure Lock cursor works in the IDE 

Disable custom property editor when no node selected 

Show warning if the new stack name begins with "rev" 

Ensure objects can not be dragged to invisible open stacks from the tools palette 
Make sure the S/B respects the "iPad initial orientations" settings 

Update guide images for LiveCode 8 

Add test to ensure default folder doesn't change when loading IDE 

Add tests for standalone builder inclusions 

Ensure tutorial has location set when being skipped 

Make outputting debug vars from message box work in all contexts 

Allow vertical scrolling in "Value" field of Variable Visualizer window 

Ensure extension is installed before deleting files 

Ensure the "Effects" settings stack always appears onscreen 

Don't try to delete breakpoint while it is a target in the call stack 
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LiveCode Builder Standard Library 


Foreign function interface 


e When passing a Number to one of the foreign integer types (LCInt, LCUInt, IntSize, 
UIntSize), an error will be thrown if the value is outside the range of the requested type. 


e The IntSize and UIntSize types can hold the full 64-bit integer range, however the 
maximum magnitude which is supported for converting to and from Number is 253. An 
error will be thrown for any conversions outside this range. 


Specific LCB bug fixes (8.1.4-rc-1) 


19067 Ensure an error is thrown if there is no script access 
19214 Increase usable range of IntSize and UlIntSize types 
19244 Nil pointers should bridge to nothing 
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Specific extension bug fixes (8.1.4-rc-1) 


19261 Clear selection when deleting selected node 
19350 Remember iconPresetName in SVG Icon when reopening 
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